home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu022.dms / pu022.adf / English / Chemesthetics.doc < prev    next >
Text File  |  1992-01-05  |  31KB  |  768 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                Chemesthetics V2.06
  31.  
  32.                                      Manual
  33.  
  34.                           (C) 1990, 1991 by Joerg Fenin
  35.  
  36.  
  37.  
  38.                                Chemesthetics V2.06
  39.      ----------------------------------------------------------------------
  40.  
  41.  
  42.                                 Table of contents
  43.  
  44.  
  45.             What is Chemesthetics . . . . . . . . . . . . . . . . . . .    3
  46.  
  47.             Copyright, Distribution etc.  . . . . . . . . . . . . . . .    3
  48.  
  49.             Installation  . . . . . . . . . . . . . . . . . . . . . . .    4
  50.                Files  . . . . . . . . . . . . . . . . . . . . . . . . .    5
  51.  
  52.             How to use Chemesthetics  . . . . . . . . . . . . . . . . .    6
  53.                The entering of data . . . . . . . . . . . . . . . . . .    6
  54.                Display a molecule . . . . . . . . . . . . . . . . . . .    7
  55.                Save a molecule  . . . . . . . . . . . . . . . . . . . .    7
  56.  
  57.             Short menu overview . . . . . . . . . . . . . . . . . . . .    8
  58.                Copyright  . . . . . . . . . . . . . . . . . . . . . . .    8
  59.                     Credits . . . . . . . . . . . . . . . . . . . . . .    8
  60.                Project  . . . . . . . . . . . . . . . . . . . . . . . .    8
  61.                     Load Mol (Amiga-L)  . . . . . . . . . . . . . . . .    8
  62.                     Save Mol (Amiga-S)  . . . . . . . . . . . . . . . .    8
  63.                     Save as IFF . . . . . . . . . . . . . . . . . . . .    8
  64.                     End (Amiga-Q) . . . . . . . . . . . . . . . . . . .    9
  65.                Edit . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  66.                     Molecule data (Amiga-M) . . . . . . . . . . . . . .    9
  67.                     Palette (Amiga-P) . . . . . . . . . . . . . . . . .    9
  68.                Paint  . . . . . . . . . . . . . . . . . . . . . . . . .    9
  69.                     Outlines (Amiga-O)  . . . . . . . . . . . . . . . .    9
  70.                     Calottes (Amiga-K)  . . . . . . . . . . . . . . . .    9
  71.                Preferences  . . . . . . . . . . . . . . . . . . . . . .   10
  72.                     Y/X relation  . . . . . . . . . . . . . . . . . . .   10
  73.                     Icon for IFF  . . . . . . . . . . . . . . . . . . .   10
  74.                     Title line  . . . . . . . . . . . . . . . . . . . .   10
  75.  
  76.             Hints for data selection  . . . . . . . . . . . . . . . . .   10
  77.  
  78.             Miscalleanous . . . . . . . . . . . . . . . . . . . . . . .   11
  79.  
  80.             Revision History  . . . . . . . . . . . . . . . . . . . . .   12
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.      ----------------------------------------------------------------------
  96.                                 Manual - 18.06.91                          2
  97.  
  98.  
  99.                                Chemesthetics V2.06
  100.      ----------------------------------------------------------------------
  101.  
  102.  
  103.  
  104.      1      What is Chemesthetics
  105.  
  106.             Chemesthetics, a  symbiose of  the words chemistry and esthetics
  107.             is a program that  displays molecules  as a  calotte model. This
  108.             kind  of  display  contains  a  certain  esthetic attitude, even
  109.             extremely poisonous  molecules  like  nicotine  or  dioxine look
  110.             quite nice.
  111.  
  112.             In June  89 a program that did exactly what was described above,
  113.             called CDCHEM has been published in  the c't  computer magazine.
  114.             It was  written by  Robert Kaufmann in TurboPascal for an MS-DOS
  115.             compatible. Unfortunately it had  two  great  disadvantages: the
  116.             input of  new data was extremly uncomfortable, and of course, it
  117.             was written for a PC (gualp!).  So  I  decided  to  re-write the
  118.             program for the Amiga.
  119.  
  120.             But  it  wasn't  as  easy  as  I had expected. Function calls in
  121.             Pascal are being done by 'call by reference' where as  in C they
  122.             are      processed   by   'call   by   value'.   I  didn't  like
  123.             pointer-arithmetic  at  this  time  very  much,  so  I  had some
  124.             difficulty in working this over.
  125.  
  126.             Finally I  was given  the deciding  kick by a program called P2C
  127.             that translates Pascal into C automatically.  A totaly confusing
  128.             but  *RUNNING*  program  was  generated,  but  it  was even more
  129.             uncomfortable than the original. So it took me another couple of
  130.             months and a lot of work to write a resonable user interface and
  131.             to make the program readable again.
  132.  
  133.  
  134.      2      Copyright, Distribution etc.
  135.  
  136.             Chemesthetics  V2.06  is  copyrighted  (C)  1991  Joerg  Fenin /
  137.             Metalworx
  138.             The arp.library is (C) copyright AmigaDos Resource Project.
  139.             The palette requester is (C) copyright 1989 Jonathan Potter.
  140.             The req.library is (C) copyright 1989 Bruce Dawson & Colin Fox.
  141.             Chemesthetics  is  Freeware,  that  means  it  may  be copied or
  142.             distributed freely as long as the following rules are obeyed:
  143.  
  144.            -   The copyright-information remains unchanged
  145.            -   The following files are distributed *TOGETHER*:
  146.                  Chemesthetics (English version)
  147.                  Chem_E.dat
  148.                  Chemesthetics.doc
  149.                 or
  150.                  Chemesthetics (German version)
  151.                  Chem_G.dat
  152.                  Chemesthetics.doc
  153.            -   The copying fee may  not be  more than  DM 5,-  rsp. not more
  154.                than $  5 in the current currency in foreign (out of Germany)
  155.  
  156.      ----------------------------------------------------------------------
  157.                                 Manual - 18.06.91                          3
  158.  
  159.  
  160.                                Chemesthetics V2.06
  161.      ----------------------------------------------------------------------
  162.  
  163.  
  164.                countries (exeception: Fred Fish, he may charge more).
  165.            -   None of the files listed above or the source file may be part
  166.                of a  commercial product  without the (written) permission of
  167.                the author.
  168.  
  169.             Copying and/or distributing is forbidden on  PD-series of Stefan
  170.             Ossowski  PD-Versand,  Rainer  Wolf  PD-Versand  (OASE), Markt &
  171.             Technik Verlag AG, Karstadt  AG  and  all  other PD-distributors
  172.             that charge more than DM 5,- / $ 5,- for one disk.
  173.  
  174.             As I am very lazy concerning donating money for freeware myself,
  175.             I don't expect to receive any donation for this program. However
  176.             I won't reject it; especially not from chemistry teachers.
  177.  
  178.             For sending  me DM  15,- /  US$ 15  you can  become a registered
  179.             user. After  sending me  the money  you will  recieve the latest
  180.             version  (including  serial  number).  Unfortunately I could not
  181.             send a printed manual anymore, 'cause I don't  have access  to a
  182.             laser printer  anymore and  I would  not allow  anyone to put up
  183.             with a printout by my last  century nine  needler. On  the other
  184.             hand I reduced the registration fee down by DM 5,- / US $ 5,-.
  185.  
  186.             (Since  banks  charge  a  high  amount  for  foreign cheques the
  187.             registration fee is US$ 15, although it is (still) more  than DM
  188.             15,-. Actually  not much  more than  DM 15,- will be left from a
  189.             US$ 15,- cheque.)
  190.  
  191.             The program may be ordered at:
  192.  
  193.                                    Joerg Fenin
  194.                                 Zum Jaegerfeld 19
  195.                                  2100 Hamburg 90
  196.                                      Germany
  197.  
  198.  
  199.      3      Installation
  200.  
  201.             Copy the Arp- and the req.library into your LIBS: drawer. That's
  202.             it! 
  203.  
  204.             (I know  it's quite  annoying to fill up your boot disk with two
  205.             libs but for the sake of a good user interface I decided  to use
  206.             the file requester of the req.library. Even though it would have
  207.             been possible to skip  the arp.library  in this  release because
  208.             just one routine is used of it (CloseWindowSafely), I decided to
  209.             leave  in  the  program  because  it  has  so  many  interesting
  210.             routines, some  of them I will certainly use in future releases.
  211.             From  Version  2.06  onward  I  use  the  official ILBM-writing-
  212.             routine (ilbmw.c) from Commodore's IFF disk (AmigaLibDisk #185),
  213.             so that I could kick out iff.library (sorry Christian, it really
  214.             wasn't  bad,  it  was  faster  than ilbmw.c, but it was too much
  215.             copying mess just for the one feature I used of it.).
  216.  
  217.      ----------------------------------------------------------------------
  218.                                 Manual - 18.06.91                          4
  219.  
  220.  
  221.                                Chemesthetics V2.06
  222.      ----------------------------------------------------------------------
  223.  
  224.  
  225.  
  226.             I hope most of the PD distributors will publish my  package as a
  227.             whole.   In   that   case   you   just  have  to  click  on  the
  228.             'Install_Library'-icons. All needed libraries will be  copied to
  229.             libs: automatically.
  230.  
  231.      3.1    Files
  232.  
  233.             The following  files are  supplied (if  not changed  by some pd-
  234.             distributor) (.info files left out!):
  235.  
  236.             Chemesthetics/
  237.                c/
  238.                     IconX               -    used by the script files
  239.                     LhArc               -    Version   1.30   of   the  file
  240.                                              compressor  (needed  to extract
  241.                                              Source.LZH)
  242.                     MuchMore            -    Text displayer
  243.  
  244.                Contents                 -    small     entry     for     the
  245.                                              AmigaLibDisk-contents file
  246.                English/
  247.                     Chemesthetics       -    main executable (English)
  248.                     Chemesthetics.doc   -    english documentation
  249.                     Chems_g.dat         -    data  file  (includes atoms and
  250.                                              its colors), needed!
  251.                     Examples/           -    some example files
  252.  
  253.                German/
  254.                     Chemesthetics       -    main executable (German)
  255.                     Chemesthetics.doc   -    German documentation
  256.                     Chems_e.dat         -    data file  (includes  atoms and
  257.                                              its colors), needed!
  258.                     Examples/           -    some example files
  259.  
  260.                Hints_for_Distributors   -    a few hints for those who would
  261.                                              like  to  include Chemesthetics
  262.                                              in a PD series
  263.                InstallLibraries         -    small script that installs arp-
  264.                                              and  req.library  in  the LIBS:
  265.                                              drawer
  266.                arp.library              -    nothing left to say
  267.                req.library              -    for the requesters
  268.  
  269.                Pictures/                -    Pictures made of the examples
  270.  
  271.                Source/
  272.                     SrcReadMe!          -    Some facts for programmers
  273.                     Source.LZH          -    all    needed    source   files
  274.                                              compressed  into   one  archive
  275.                                              (use lharc to extract)
  276.                          lmkfile        -    type  lmk  (Lattice users only)
  277.  
  278.      ----------------------------------------------------------------------
  279.                                 Manual - 18.06.91                          5
  280.  
  281.  
  282.                                Chemesthetics V2.06
  283.      ----------------------------------------------------------------------
  284.  
  285.  
  286.                                              for automatic compile and link
  287.                          arpbase.h      -    include file for the use of the
  288.                                              arp.library  (has  to be copied
  289.                                              to INCLUDE:libraries/)
  290.                          *.c            -    C source files
  291.                          *.h            -    includes for the above
  292.  
  293.  
  294.      4      How to use Chemesthetics
  295.  
  296.             The basis for  each  molecule  are  atoms.  A  watermolecule for
  297.             example  consists  of  one  oxygen  and  two hydrogen atoms. The
  298.             position of the atoms must be told to the program as well as the
  299.             position of the light source, the twisting and the reflection of
  300.             the molecule.
  301.  
  302.             Out of this data a calotte model of the molecule  is calculated.
  303.             Entered  data  may  be  saved  and  restored  for  later  use. A
  304.             completed picture can be saved as an IFF graphics file.
  305.  
  306.  
  307.      4.1    The entering of data
  308.  
  309.             Select 'Molecule data' from the input menu.
  310.  
  311.             A new  window opens  where you  can enter  the data.  To do this
  312.             switch the  edit gadget  to ADD. The cursor appears in the first
  313.             of the input gadgets. Enter here the short sign of the atom, for
  314.             example O for oxygen. Press <RETURN> and the cursor jumps to the
  315.             next string gadget, the  position  field  for  the x-coordinate.
  316.             Enter 160  for example. Do this analogly for the coordinates for
  317.             Y and Z. Finally enter  the  radius  for  the  atom.  The radius
  318.             describes the size of the atom. The higher the radius the bigger
  319.             the atom. Size relationships of the  atoms  can  be  found  in a
  320.             usual chemistry book.
  321.  
  322.             The axises lay in space as follows:
  323.  
  324.  
  325.                    ^   _
  326.                  z |   /|
  327.                    |  / y
  328.                    | /
  329.                    |/
  330.                    *-----> x
  331.  
  332.             You'll find some examples in the .cdm-files.
  333.  
  334.             Enter all  atoms of  a molecule one after another. The locations
  335.             of the atoms to each other can be also found in chemistry books.
  336.             In addition you'll find some examples on the disk. With "Project
  337.             - Load molecule" they may be loaded.
  338.  
  339.      ----------------------------------------------------------------------
  340.                                 Manual - 18.06.91                          6
  341.  
  342.  
  343.                                Chemesthetics V2.06
  344.      ----------------------------------------------------------------------
  345.  
  346.  
  347.  
  348.             After  entering  all  atoms,   Chemesthetics  needs   some  data
  349.             concerning the molecule as a whole:
  350.  
  351.             The magnifiction factor (MagnFactor) expresses the magnification
  352.             of the whole molecule. A magnification facter of  1.0 leaves the
  353.             molecule  unchanged,  a  magnification  factor  < 1.0 shrinks, a
  354.             magnification factor > 1.0 expands the molecule.
  355.  
  356.             The following three values express the twisting of  the molecule
  357.             in  space.  It  may  be  twisted around any of the three axises.
  358.             Therefore enter the desired values in the string gadgets.
  359.  
  360.             Now follow the values for the light source. Chemesthetics uses a
  361.             kind  of  ray  tracing  algorithm  to create a three dimensional
  362.             appearance for the calotte model. Even  shadowing is  taken into
  363.             consideration. To do this a vector of the light source has to be
  364.             entered. A reasonable value  is for  example X=20000, Y=-100000,
  365.             Z=20000.  All  inputs  are  made  in  picometers  (1  pm = 10-12
  366.             meters). All example molecules on the disk use this vector.
  367.  
  368.             The last value that has to be entered, declares the  relexion of
  369.             the atoms. The higher the reflection the stronger will the light
  370.             source be reflected in each atom.  A value  of 100  will reflect
  371.             the light like a mirror (i.e. the atom will appear white).
  372.  
  373.             Is  everything  correct  click  on  the OK-gadget, to cancel all
  374.             inputs click the CANCEL-gadget or the closegadget.
  375.  
  376.  
  377.      4.2    Display a molecule
  378.  
  379.             You'll find two menuitems  in the  menu "Paint",  i.e. 'Outline'
  380.             and 'Calottes'.  If you  select 'Outline'  just a circle will be
  381.             painted for each atom. It  gives  you  a  quick  survey  how the
  382.             molecoule  will  look  like.  This  mode gives you the chance to
  383.             experiment with different data (mostly twists) without having to
  384.             wait for  hours just  to see it's not what you wanted. Certainly
  385.             the stereoscopic effect may be lost.
  386.  
  387.             If you are satisfied with all the values  select 'Calottes'. The
  388.             molecule will  be drawn considering all the data including light
  389.             and reflection. Because of the mass of data large molecules like
  390.             dioxine can take up to one hour until they are finished. But the
  391.             result compensates the efforts.
  392.  
  393.             A calotte painting may be interrupted anytime by clicking on the
  394.             left mouse button.
  395.  
  396.      4.3    Save a molecule
  397.  
  398.             In   the   "Project"   menu   you'll  find,  among  others,  two
  399.  
  400.      ----------------------------------------------------------------------
  401.                                 Manual - 18.06.91                          7
  402.  
  403.  
  404.                                Chemesthetics V2.06
  405.      ----------------------------------------------------------------------
  406.  
  407.  
  408.             'save'-menuitems, i.e. 'Save molecule'  and 'Save  IFF'. Use the
  409.             first to  save the  molecule as a Chemsthetics datafile, it will
  410.             get, if not changed, the extension .cdm.
  411.  
  412.             With 'Save IFF' the screen will  be  saved  as  an  IFF graphics
  413.             file. If  'Icon for IFF' was selected in the preferences menu an
  414.             icon will be saved along with the file.
  415.  
  416.  
  417.  
  418.      5      Short menu overview
  419.  
  420.  
  421.      5.1    Copyright
  422.  
  423.             Copyright-Information
  424.  
  425.  
  426.      5.1.1  Credits
  427.  
  428.             Information about who supported the completion of this programm.
  429.  
  430.  
  431.      5.2    Project
  432.  
  433.             Input and output functions
  434.  
  435.  
  436.      5.2.1  Load Mol (Amiga-L)
  437.  
  438.             Opens the (great) file requester of  the req.library  (thanks to
  439.             Bruce  &  Colin)  and  loads,  after  selecting  the  name,  the
  440.             corresponding molecule file. If  Chemesthetics detects  an error
  441.             in the data it will display a warning. In this case it is highly
  442.             recommended   that   you   check    the   data    by   selecting
  443.             "Input...molecular data".
  444.  
  445.  
  446.      5.2.2  Save Mol (Amiga-S)
  447.  
  448.             Opens the  file requester and saves, after entering or selecting
  449.             the name, the current data as a Chemesthetics data file (.cdm).
  450.  
  451.  
  452.      5.2.3  Save as IFF
  453.  
  454.             Saves the screen as an IFF file. This file may be read by any of
  455.             the current graphic programs (like DPaint or Butcher).
  456.  
  457.             By default an icon will be saved along with the file. It will be
  458.             a  PROJECT  icon  with  'C:IView'  as  the  project's  tool. See
  459.             'Preferences...Icon for IFF' to prevent icon creation.
  460.  
  461.      ----------------------------------------------------------------------
  462.                                 Manual - 18.06.91                          8
  463.  
  464.  
  465.                                Chemesthetics V2.06
  466.      ----------------------------------------------------------------------
  467.  
  468.  
  469.  
  470.             Any IFF  file will be compressed, using the official compression
  471.             algorithm provided by ilbmw.c from Commodore's official IFF disk
  472.             (AmigaLibDisk #185).  I personally don't know any tool that does
  473.             not work with this compression mode. However there  are tools to
  474.             convert compressed files into uncompressed ones.
  475.  
  476.  
  477.      5.2.4  End (Amiga-Q)
  478.  
  479.             Terminates the program.
  480.  
  481.  
  482.      5.3    Edit
  483.  
  484.             Data input and color changing
  485.  
  486.  
  487.      5.3.1  Molecule data (Amiga-M)
  488.  
  489.             The input  window will  be opened  and, if  present, the current
  490.             molecule data will be displayed in  a list.  You can  scroll the
  491.             list with the arrows or the proportional gadget. The atom's data
  492.             may be changed if you click on an  atom and  the mode  gadget is
  493.             switched to "EDIT". You can add new atoms to the molecule if you
  494.             switch the mode gadget to "ADD".
  495.  
  496.  
  497.      5.3.2  Palette (Amiga-P)
  498.  
  499.             Here you can change  all  of  the  16  colors  of Chemesthetics.
  500.             Please note that most of the colors are used by Chemesthetics to
  501.             draw the atoms. The  color distribution  vastly corresponds with
  502.             Antropow's  color   distribution  for  atoms.  You  can  restore
  503.             Chemesthetics' defaults by clicking on the "DEFAULT" gadget.
  504.             At this point I would like  to  thank  Jonathan  Potter  for his
  505.             paletterequester.
  506.  
  507.  
  508.      5.4    Paint
  509.  
  510.             Selection of the paint mode.
  511.  
  512.  
  513.      5.4.1  Outlines (Amiga-O)
  514.  
  515.             Draws  only  the  outlines  of  each  atom. It serves as a quick
  516.             survey whether the entered data is  right or  wrong. Reflection,
  517.             shadowing etc. are not considered.
  518.  
  519.  
  520.      5.4.2  Calottes (Amiga-K)
  521.  
  522.      ----------------------------------------------------------------------
  523.                                 Manual - 18.06.91                          9
  524.  
  525.  
  526.                                Chemesthetics V2.06
  527.      ----------------------------------------------------------------------
  528.  
  529.  
  530.  
  531.             Draws a  calotte model  considering ALL entered data. Because of
  532.             the mass of data it can take up to one  hour or  more to  draw a
  533.             large molecule.
  534.  
  535.  
  536.      5.5    Preferences
  537.  
  538.             Preferences of Chemesthetics
  539.  
  540.  
  541.      5.5.1  Y/X relation
  542.  
  543.             Because of  different screen  resolutions in x- and y-direction,
  544.             circles usually  appear  as  ellipses.  The  y/x  relation value
  545.             corrects  this.  Chemesthetics  automatically assumes a value of
  546.             1.5 for PAL screens (256 pixels in y-direction) and 2.0 for NTSC
  547.             screens (200  pixels in y-direction). However you could manually
  548.             overwrite this value.
  549.  
  550.  
  551.      5.5.2  Icon for IFF
  552.  
  553.             Here you can decide whether an icon will be saved along with the
  554.             IFF graphics  file (default)  or not.  The icon  will be of type
  555.             PROJECT with 'C:IView' as its tool. If you  copy IView (provided
  556.             for example  on this disk, if this is an AmigaLibDisk) to the C:
  557.             drawer of your boot(hard)disk, you can easily view all the drawn
  558.             pictures by simply double-clicking on the icons.
  559.  
  560.  
  561.      5.5.3  Title line
  562.  
  563.             In order to get more space for the drawing (especially important
  564.             on NTSC screens I presume), I switched off  the menu  line since
  565.             version 2.05.  That means that you have to press the menu button
  566.             of your mouse (right mouse button)  to get  the program's menus.
  567.             However if  you would  like to have it there permanently you can
  568.             switch this gadget (and the menu line) on. Another click on this
  569.             gadget switches off the title line again.
  570.  
  571.  
  572.      6      Hints for data selection
  573.  
  574.             Most of  the needed  data may be extracted from simple chemistry
  575.             books. Calotte models are  shown there  very often.  If they are
  576.             not too  complex they  may be  taken over  easily. Also the size
  577.             relationships between atoms are shown in tables or  outlines, so
  578.             there is  no need to guess. Another good source for atom data is
  579.             the  shareware  program  Elements  by  Paul  Miller  located for
  580.             example on AmigaLibDisk 384.
  581.  
  582.  
  583.      ----------------------------------------------------------------------
  584.                                 Manual - 18.06.91                         10
  585.  
  586.  
  587.                                Chemesthetics V2.06
  588.      ----------------------------------------------------------------------
  589.  
  590.  
  591.             To get  a feeling  for the  data you could also have a look into
  592.             the example data files that (should) come with this program. You
  593.             could compare those data easily with the corresponding data in a
  594.             chemistry book. The water  molecule  for  example  can  be found
  595.             almost every chemistry book.
  596.  
  597.             May  be  I  will  release  some  more data files later on public
  598.             domain disks.
  599.  
  600.  
  601.      7      Miscalleanous
  602.  
  603.             I would be very  pleased  to  receive  suggestions  of  any kind
  604.             (improvements,  error  reports  etc.).  If  someone modifies the
  605.             source code I  would  like  to  receive  a  copy.  Besides  I am
  606.             interested in  modifications concerning  the new  5.0 Version of
  607.             the Aztec C Compiler.
  608.  
  609.             Chemesthetics automatically recognises if it runs on a  NTSC- or
  610.             PAL-machine. 
  611.  
  612.             This program  has been  written in  C and  has been compiled and
  613.             optimized under  the  SAS/Lattice  C  compiler  V5.10a.  It uses
  614.             routines  of   the  arp.library  (CloseWindowSafely())  and  the
  615.             req.library (FileRequester(), SimpleRequest(), TwoGadRequest()).
  616.  
  617.             The program was tested under the following environment:
  618.             Amiga500
  619.             Kickstart 1.2
  620.             512 KByte RAM Extension
  621.             arp.library Version 39.1
  622.             req.library Version 2.5
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.      ----------------------------------------------------------------------
  645.                                 Manual - 18.06.91                         11
  646.  
  647.  
  648.                                Chemesthetics V2.06
  649.      ----------------------------------------------------------------------
  650.  
  651.  
  652.      8      Revision History
  653.  
  654.             (sorted descending, the most recent version is at the top of the
  655.             list)
  656.  
  657.             V2.06 - 13.06.91  -    Now  using   ilbmw.c  from  the  official
  658.                                    Commodore IFF disk (AmigaLibDisk #185) to
  659.                                    do the  IFF saving,  as a result I kicked
  660.                                    out the iff.library (sorry Christian).
  661.                               -    Possibility to  let  an  icon  be created
  662.                                    automatically when an iff file is written
  663.                                    (default)
  664.  
  665.             V2.05 - 29.04.91  -    Switched off the menu  line  to  get more
  666.                                    space for  the drawings, i.e. you have to
  667.                                    use the menu button of your  mouse to get
  668.                                    the menus.  (could be  turned on again in
  669.                                    the preferences menu)
  670.                               -    Changed  the   main   window's   type  to
  671.                                    BACKDROP,  that   means  that  requesters
  672.                                    could  not  be  put   in  the  background
  673.                                    anymore, also it does not contain a title
  674.                                    line anymore to get  a bit  more room for
  675.                                    the drawings.
  676.  
  677.             V2.04 - 21.04.91  -    Implemented  use  of  the  req.library of
  678.                                    Bruce Dawson & Colin  Fox.  Now  its file
  679.                                    requester is  used instead  of the one of
  680.                                    the  arp.library.  Also  removed  my  own
  681.                                    MessageRequest() and  exchanged it by the
  682.                                    related routines of the req.library
  683.                               -    Small window with the  serial number will
  684.                                    be displayed  on startup, detaches itself
  685.                                    after a few seconds if not  closed by the
  686.                                    user
  687.  
  688.             V2.03 - 13.04.91  -    preferences window to set up y/x relation
  689.                                    and  iff  saving  mode  (actually because
  690.                                    there was a bug with the checkmark in the
  691.                                    preferences menu)
  692.                               -    fixed  bug   in   SaveIFF  (Chemesthetics
  693.                                    didn't take over the entered file name)
  694.                               -    changed  colors  to  get  a  slight OS2.0
  695.                                    feeling
  696.                               -    drawing statistics  (time  and  number of
  697.                                    atoms)
  698.                               -    removed some minor bugs
  699.  
  700.                          (This version became possible because the first (!,
  701.                          not bad ?) registered user wrote  in and  asked for
  702.                          the  latest  version.  Actually  the  was no runnig
  703.                          version at this time, so I had to sit down  and did
  704.  
  705.      ----------------------------------------------------------------------
  706.                                 Manual - 18.06.91                         12
  707.  
  708.  
  709.                                Chemesthetics V2.06
  710.      ----------------------------------------------------------------------
  711.  
  712.  
  713.                          some work to get it run again. Thanks Jim!)
  714.  
  715.             V2.02 - 10.03.91  -    recompiled  under  SAS/Lattice  C  5.10a,
  716.                                    therefore   some    minor   changes   and
  717.                                    adaptions had to be done
  718.                               -    optimized  run-time performance, drawings
  719.                                    are now ca. 30% faster
  720.  
  721.             V2.01 - 17.02.91  -    data   is   not   linked   into  chip-mem
  722.                                    automatically       anymore,      instead
  723.                                    TypeOfMem() is used for  graphics data to
  724.                                    decide wheter  to transfer  it into chip-
  725.                                    mem  or  if  it   is  already   there  by
  726.                                    coincidence.
  727.                               -    editing  of  non  existing  atoms  is not
  728.                                    longer possible
  729.                               -    editing is  not longer  possible when you
  730.                                    are in ADD-mode
  731.                               -    several minor changes
  732.  
  733.             V2.00 - 27.12.90  -    first published version
  734.  
  735.             V1.00 - Spring 1990 -  first running version
  736.  
  737.      Chemesthetics V2.06 (C) 1990,1991 Metalwox, Manual update: 18.06.91
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.      ----------------------------------------------------------------------
  767.                                 Manual - 18.06.91                         13
  768.